ProtectEntry

ProtectEntry
Header:	Quickdraw.h		Carbon status:	Supported

Adds protection to or removes protection from an entry in the current GDevice data structure’s color table. This function is used by system software and your application should not need to call it.

void ProtectEntry (
    SInt16 index, 
    Boolean protect
);

Parameter descriptions

index: The index to the entry whose protection is to be changed.
protect: A Boolean value: specify true to protect the entry, false to remove protection.

DISCUSSION

A protected entry can not be changed by other applications. ProtectEntry returns a protection error in QDErr if you attempt to protect an already protected entry. However, it can remove protection from any entry, even an already unprotected one.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.